Dimensions

本文將說明 YouTube Reporting API 支援的維度。這項 API 可擷取大量報表，內含頻道或內容擁有者的 YouTube 數據分析資料。

維度是用來匯總資料的常見條件，例如使用者活動發生的日期，或是使用者所在國家/地區。

每份大量報表都支援預先定義的維度清單，且在任何報表中，每列資料都含有獨特的維度值組合。因此，每個資料列的維度值組合都會做為該資料列的主鍵。您不需要指定報表中要納入哪些維度，也沒有指定的選項。

核心維度

雖然 YouTube 報表 API 須遵守《服務條款》中定義的停用政策，但非核心維度 (和非核心指標) 不受這項政策規範。在本頁的定義中，任何核心維度都會明確標示為核心維度。

以下清單列出 API 的核心維度。這些都是 YouTube Analytics API 中的核心維度。

詳情請參閱 YouTube API 廢止政策適用範圍清單。

尺寸

以下各節會定義 YouTube 報表 API 大量報表中使用的維度。除非另有說明，否則這些維度會同時用於頻道和內容擁有者報表。

資源

這些維度與頻道和內容擁有者在 YouTube 上管理的資源相對應：

video_id (核心維度)
YouTube 影片 ID。在 YouTube Data API 中，這是 video 資源的 id 屬性值。This is a core dimension and is subject to the Deprecation Policy.
playlist_id
YouTube 播放清單 ID。在 YouTube Data API 中，這是 playlist 資源 id 屬性的值。
channel_id (核心維度)
YouTube 頻道的 ID。在 YouTube Data API 中，這是 channel 資源 id 屬性的值。This is a core dimension and is subject to the Deprecation Policy.
asset_id (僅用於內容擁有者報表)
在 YouTube Content ID 系統中管理的資產 ID。資產是指在該系統中代表你的智慧財產的項目。你可以在 YouTube 網站的 YouTube 內容管理員中找到資產 ID。你也可以使用 YouTube Content ID API 擷取這些資訊。

地理區域

這些維度可識別與使用者活動、廣告成效或預估收益指標相關的地理區域。

country_code (核心維度)
與報表列中指標相關聯的國家/地區。維度值是兩個字母的 ISO-3166-1 國家/地區代碼，例如 US、CN (中國) 或 FR (法國)。國家/地區代碼 ZZ 用於回報 YouTube 無法識別相關國家/地區的指標。This is a core dimension and is subject to the Deprecation Policy.
province_code
與報表列中指標相關聯的美國州或領土。這個維度值是 ISO 3166-2 代碼，可用於識別美國州或哥倫比亞特區，例如 US-MI (密西根州) 或 US-TX (德州)。省份代碼 US-ZZ 用於回報 YouTube 無法識別相關美國州別的指標。

注意：這個維度不支援用於識別美國外圍地區的 ISO 3166-2 值，因為這些地區也有自己的 ISO 3166-1 國家/地區代碼。也無法支援美國以外國家/地區的行政區劃。

時間範圍

date (核心維度)
這個維度會識別與報表各列指標相關聯的日期。在大量報表中，日期是指指定日期、月份和年份的凌晨 12 點 太平洋時間至晚上 11 點 59 分 太平洋時間這段期間。太平洋時間會根據季節而定，為 UTC-7 或 UTC-8。

請注意，雖然日期通常代表 24 小時的時間範圍，但如果時鐘調整為夏令時間，則日期代表 23 小時的時間範圍，如果時鐘調整為冬令時間，則日期代表 25 小時的時間範圍。This is a core dimension and is subject to the Deprecation Policy.

播放位置

這些維度可提供使用者活動發生的網頁或應用程式相關洞察資料。

playback_location_type
這個維度會識別使用者活動發生的網頁或應用程式類型。下表列出維度值：
值
0 這類資料與影片的 YouTube 觀賞頁面或官方 YouTube 應用程式 (例如 YouTube Android 應用程式) 中的活動有關。
1 這項資料與使用 <iframe> 或 <object> 嵌入功能嵌入影片的其他網站或應用程式上發生的活動有關。
2 這項資料與 YouTube 頻道頁面上的活動有關。
5 這項資料與無法歸類為其他所列地區類型的指標有關。
7 這項資料與 YouTube 首頁或主畫面、使用者的訂閱頻道動態消息，或其他 YouTube 瀏覽功能的觀看次數相關。
8 這項資料是指直接在 YouTube 搜尋結果網頁上產生的觀看次數。
10 這項資料與 YouTube Shorts 動態的觀看次數相關。
playback_location_detail
這個維度會指定播放發生的網址或應用程式。這項維度僅支援嵌入式播放器中的觀看次數，也就是說，只有在維度值為 1 的資料列中，才會填入維度值。在其他資料列中，這個維度的值為空白。

播放詳細資料

live_or_on_demand
這個維度會指出資料列中的使用者活動指標是否與直播觀看次數相關。這個維度的資料適用於 2014 年 4 月 1 日以後的日期。

下表列出維度值：
值
live 這一列的資料會說明直播期間發生的使用者活動。
onDemand 這一列的資料會說明直播期間未發生的使用者活動。
subscribed_status
這個維度會指出資料列中的使用者活動指標是否與訂閱影片或播放清單頻道的觀眾相關。 可能的值為 subscribed 和 unsubscribed。

請注意，維度值會在使用者活動發生時保持準確。舉例來說，假設使用者尚未訂閱某個頻道，並觀看該頻道的其中一部影片，然後在同一天訂閱該頻道並觀看另一部影片。 頻道的報表指出，其中一個觀看次數的 subscribed_status 值為 subscribed，另一個觀看次數的 subscribed_status 值為 unsubscribed。

流量來源

traffic_source_type
這個維度會指出與使用者活動指標相關聯的參照來源類型。推薦來源類型會說明使用者觀看與報表中資料列相關聯的影片或頻道的方式。下表列出維度值：
值
0 直接或不明來源
這個值涵蓋網頁的直接流量，以及參照來源不明的網頁。在查詢報表中，這類流量來源會標示為 NO_LINK_OTHER 或 UNKNOWN_MOBILE_OR_DIRECT。
1 YouTube 廣告
觀眾是透過廣告連到影片。在流量來源報表中，如果這個維度的值為 1，則 traffic_source_detail 維度會指出向觀眾顯示的廣告類型。在查詢報表中，這類流量來源會標示為 ADVERTISING。可能的值包括：
值
ctp_engagement_ad 隨點即播參與式廣告
engagement_ad 參與式廣告
googlemediaads Google 搜尋廣告
insearch_display TrueView 搜尋結果廣告和多媒體廣告
instream TrueView 串流內廣告
instream-select 預留的可略過串流內廣告
unknown 未分類的 YouTube 廣告
video_wall 影片縮圖
yva 首頁影片廣告
3 瀏覽功能
觀眾是透過 YouTube 頁面連結到影片或頻道。在流量來源報表中，如果這個維度的值是 3，則 traffic_source_detail 維度會指出引入流量的功能。在查詢報表中，這類流量來源會標示為 SUBSCRIBER。可能的值包括：
值
explore 兒童：探索
learning 兒童：學習
music 音樂動態消息
my-history 觀看記錄
my-subscriptions 訂閱內容
my-uploads 我上傳的內容
podcasts Podcast 專頁
shows 兒童：節目
watch-later 稍後觀看
what-to-watch 推薦內容
4 YouTube 頻道
觀眾是從 YouTube 頻道頁面轉介而來。在流量來源報表中，如果這個維度的值為 4，則 traffic_source_detail 維度會指定該管道的管道 ID。在查詢報表中，這類流量來源會標示為 YT_CHANNEL。
5 YouTube 搜尋
觀眾是透過 YouTube 搜尋結果找到你的頻道。在流量來源報表中，如果這個維度的值是 5，則 traffic_source_detail 維度會指定相關搜尋字詞。在查詢報表中，這類流量來源會標示為 YT_SEARCH。
7 建議的影片
：觀眾是從其他影片觀賞頁面上的相關影片清單轉介而來。在流量來源報表中，如果這項維度的值為 7，則 traffic_source_detail 維度會識別該影片的影片 ID。在查詢報表中，這類流量來源會標示為 RELATED_VIDEO 或 YT_RELATED。
8 其他 YouTube 功能
觀眾是從不屬於上述流量來源類型的 YouTube 網頁轉介而來。在流量來源報表中，如果這個維度的值是 8，則 traffic_source_detail 維度會識別網頁網址。在查詢報表中，這類流量來源會標示為 YT_OTHER_PAGE。可能的值包括：
值
g-crec 推薦頻道
offline 離線
promotion 合作夥伴宣傳計劃
unknown 不明
widget Android 主畫面小工具
youtu.be youtu.be
ytremote YouTube 遙控器
9 外部
觀眾是透過其他網站上的連結轉介而來。這類流量來源包括來自 Google 搜尋結果的轉介。在流量來源報表中，如果這個維度的值是 9，則 traffic_source_detail 維度會標示外部網頁。在查詢報表中，這類流量來源會標示為 EXT_URL。
11 影片資訊卡和註解
觀眾是透過點選其他影片中的註解或資訊卡而轉介而來。在查詢報表中，這類流量來源會標示為 ANNOTATION。
14 播放清單
：影片收錄在播放清單中時獲得的觀看次數。在查詢報表中，這類流量來源會標示為 PLAYLIST。

請注意，這個流量來源與來源類型 18 不同，後者表示觀看次數來自列出播放清單中所有影片的頁面。
17 通知
：觀眾是透過 YouTube 的電子郵件或通知而來。在查詢報表中，這類流量來源會標示為 NOTIFICATION。可能的值包括：
值
inbox
push
sdig 來自訂閱者摘要通知的觀看次數
uploaded_other 來自非推播通知的觀看次數，例如上傳影片時傳送給訂閱者的電子郵件或收件匣通知
uploaded_push 上傳影片時，向訂閱者傳送推播通知後產生的觀看次數
18 播放清單頁面
觀看次數來自列出播放清單中所有影片的頁面。在查詢報表中，這類流量來源會標示為 YT_PLAYLIST_PAGE。

請注意，這個流量來源與來源類型 14 不同，後者表示觀眾在播放播放清單中的影片時觀看了影片。
19 來自已聲明版權的內容
：使用者上傳的已聲明版權影片，內容擁有者用來宣傳該內容的觀看次數。在查詢報表中，這個流量來源會標示為 CAMPAIGN_CARD。這項流量來源僅適用於內容擁有者報表。
20 互動式影片片尾
觀看次數來自其他影片的片尾。在查詢報表中，這類流量來源會標示為 END_SCREEN。
23 Stories：
觀眾是從 Stories 觀看體驗中的前一支影片，以垂直滑動方式前往該影片。
24 Shorts
觀眾在 Shorts 觀看體驗中，從前一支影片垂直滑動切換至這部影片。
25 產品頁面
產品頁面上的影片將觀眾帶往其他頻道。
26 主題標記頁面
來自 VOD 主題標記頁面或 Shorts 主題標記樞紐頁面的觀看次數。
27 音效使用頁面
：來自 Shorts 音效使用頁面的觀看次數。
28 直播重新導向
來自直播重新導向的觀看次數。
29 Podcast
YouTube 播客頁面帶來的觀看次數。
30 重混影片
觀看次數來自 Shorts 播放器中重混影片連結。
31 直向直播動態
來自直向直播動態的觀看次數。
32 相關影片
：觀看次數來自 Shorts 播放器中的相關影片連結。
traffic_source_detail
這個維度會提供資料列的 traffic_source_type 維度值所代表的流量來源的其他詳細資料。系統會為下列 traffic_source_type 維度值填入這項維度值：
  • 1：維度值會識別向觀眾顯示的廣告類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 3：這個尺寸值會標示帶來轉介流量的 YouTube 功能。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 4：維度值會指定觀眾的導向管道 ID。
  • 5：維度值會指定促成參照流量的搜尋字詞。
  • 7：維度值會指出觀眾是從哪部影片前往觀看。
  • 8：維度值會指出帶來參照流量的 YouTube 網頁類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 9：維度值會指出流量來自哪個外部網頁。
  • 17：維度值會指出導致參照流量的通知類型。如需可能值的清單，請參閱 traffic_source_type 定義。
  • 19：維度值會指出觀眾是從哪部影片前往觀看。
  • 20：維度值會指出觀眾是從哪部影片前往觀看。
  • 25：維度值會識別產品 ID (Google 知識圖譜 ID)。
  • 26：維度值會標示出導致參照流量的主題標記。
  • 27：維度值會指出觀眾是從哪部影片前往觀看。
  • 28：此維度值會指定觀眾透過直播重新導向功能所來自的頻道 ID。
  • 30：維度值會指定觀眾是透過哪部影片而來。

裝置

device_type
這個維度會指出檢視畫面所在裝置的實體板型規格。下表列出有效的維度值：
值
100 不明
101 電腦
102 電視
103 遊戲主機
104 行動電話
105 平板電腦
operating_system
這個維度可識別觀看次數發生時所用的裝置軟體系統。下表列出有效的維度值：
值
1 其他
2 Windows
3 Windows Mobile
4 Android
5 iOS
6 Symbian
7 Blackberry
9 Macintosh
10 PlayStation
11 Bada
12 WebOS
13 Linux
14 Hiptop
15 MeeGo
16 Wii
17 Xbox
18 PlayStation Vita
19 智慧型電視
20 Nintendo 3DS
21 Chromecast
22 Tizen
23 Firefox
24 RealMedia
25 KaiOS
26 Roku
27 Nintendo Switch
28 Apple tvOS
29 Fire OS
30 ChromeOS
31 Vidaa

客層

客層維度可協助您瞭解觀眾的年齡層和性別分布情況，YouTube 說明中心提供 YouTube Analytics 報表中客層資料的其他資訊。

age_group(核心維度)
這個維度會指出與報表資料相關聯的登入使用者年齡層。API 使用下列年齡層：
  • AGE_13_17
  • AGE_18_24
  • AGE_25_34
  • AGE_35_44
  • AGE_45_54
  • AGE_55_64
  • AGE_65_
This is a core dimension and is subject to the Deprecation Policy.
gender(核心維度)
這個維度會識別與報表資料相關聯的已登入使用者性別。有效值為 FEMALE、MALE 和 GENDER_OTHER。This is a core dimension and is subject to the Deprecation Policy.

互動和內容分享

sharing_service (核心維度)
這個維度會指出用來分享影片的服務。你可以使用「分享」按鈕，在 YouTube 上 (或透過 YouTube 播放器) 分享影片。This is a core dimension and is subject to the Deprecation Policy.

下表列出有效的維度值：
值
0 不明
1 Digg
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! 日本
8 goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
34 Blogger
36 VKontakte (ВКонтакте)
37 Rakuten (樂天市場)
38 LiveJournal
39 Odnoklassniki (Одноклассники)
40 tumblr。
42 LinkedIn
43 Google+
44 微博
45 Pinterest
46 電子郵件
47 Facebook Messenger
49 WhatsApp
50 Hangouts
51 Gmail
52 Kakao (Kakao Talk)
53 其他
55 複製到剪貼簿
59 嵌入
60 簡訊
61 Android 訊息
62 Verizon 訊息
63 HTC 簡訊
64 Sony Conversations
65 Go SMS
66 LGE 電子郵件
67 折線圖
68 Viber
69 Kik
70 Skype
71 BlackBerry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 Facebook 粉絲專頁
77 GroupMe
78 Android 電子郵件
79 Motorola Messaging
80 鄰近分享
81 Naver
82 iOS 系統活動對話方塊
83 Google 信箱
84 Android Messenger
85 YouTube Music
86 YouTube Gaming
87 YouTube Kids
88 YouTube TV

詳情請參閱說明文件。

註解

annotation_type
這個維度會指出註解在影片中顯示的方式。下表列出可能的維度值：
值
0 不明
1 注意事項
3 精選內容
4 標題
8 對話說明圖示
9 標籤
10 品牌浮水印
11 精選影片
12 精選播放清單
30 行動號召
YouTube 說明中心提供更多詳細資訊，說明不同類型的註解以及在影片中加入註解的程序。
annotation_id
YouTube 用於識別註解的 ID。

資訊卡

card_type
這個維度會識別向使用者顯示的資訊卡類型。下表列出可能的維度值：
值
0 不明
60 連結
61 募款活動
62 影片
63 播放清單
65 粉絲贊助
66 商品
68 關聯網站
69 頻道
YouTube 說明中心提供更多資訊，說明各種資訊卡類型以及新增資訊卡至影片的程序。
card_id
YouTube 用來識別資訊卡的 ID。

片尾

end_screen_element_type
這個維度會指出向使用者顯示的片尾元素類型。下表列出結束畫面元素類型及其值：
值
501 影片：宣傳其他 YouTube 影片的元素。
502 播放清單：宣傳 YouTube 播放清單。
503 網站：連結至相關網站的元素。
504 管道：元素連結至其他管道。
505 訂閱：鼓勵觀眾訂閱你的頻道。
506 關聯
507 群眾募資：連結至已核准的群眾募資網站。
508 商品：連結至核准的商品網站。
509 最近上傳：連結至頻道最近上傳的影片。
510 配合觀眾喜好
end_screen_element_id
YouTube 用來識別結束畫面元素的 ID。

字幕

subtitle_language
這個維度會指出在觀看期間使用最久的字幕語言。系統不會計算大部分觀眾關閉隱藏式輔助字幕的觀看次數。如要進一步瞭解含有這個維度的報表，請參閱頻道報表或內容擁有者報表的說明文件。
subtitle_language_autotranslated
這項維度會指出觀看期間使用最久的自動翻譯字幕語言。系統不會計算大部分觀眾關閉隱藏式輔助字幕的觀看次數。如要進一步瞭解含有這個維度的報表，請參閱頻道報表或內容擁有者報表的說明文件。

廣告成效

廣告類型
「ad_type」維度會用於廣告成效報表，並根據影片播放期間放送的廣告類型匯總所要求的指標。下表列出可能的維度值。如要進一步瞭解 YouTube 廣告格式，請前往 YouTube 說明中心。
值 說明 查詢報表中的值
1 可略過的影片廣告 (競價) auctionTrueviewInstream
2 多媒體廣告 (競價) auctionDisplay
3 不可略過的影片廣告 (競價) auctionInstream
5 多媒體廣告 (預訂) reservedDisplay
6 不可略過的影片廣告 (預訂) reservedInstream
13 不明 unknown
15 可略過的影片廣告 (保留) reservedInstreamSelect
19 串場廣告 (競價) auctionBumperInstream
20 串場廣告 (已預訂) reservedBumperInstream

注意：查詢報表可能會針對先前在 YouTube 上使用的部分額外廣告類型傳回資料。

內容擁有者維度

下列維度僅用於內容擁有者報表。

claimed_status(僅用於內容擁有者報表)
這個維度表示資料列只包含已聲明內容的指標。這項維度的唯一有效值為 claimed。uploader_type 維度的定義中提供的資料表，可進一步說明如何使用這個維度。
uploader_type(核心維度)(僅用於內容擁有者報表)
這個維度會指出資料列是否包含指定內容擁有者上傳的內容，以及/或第三方上傳的內容 (例如使用者上傳的影片) 的評估指標。有效值為 self 和 thirdParty。這是核心維度，並受淘汰政策的規範。

下表列出 claimed_status 和 uploader_type 維度支援的組合：

claimed_status值 uploader_type值 說明
[未設定] self 這一列包含內容擁有者上傳的已聲明著作權和未聲明著作權內容的 YouTube 數據分析資料。
已聲明版權 self 這一列包含內容擁有者上傳的已聲明版權內容資料。
已聲明版權 thirdParty 這一列包含第三方上傳的已聲明版權內容資料。